NS Basic/Palm 4.4 Release Notes
Book Edition

September 23, 2004

Copyright 2004 NS BASIC Corporation


Contents

  1. Book Edition
  2. How to Install NS Basic/Palm
  3. How to run your program on your Desktop
  4. Warnings
  5. Documentation
  6. Support

Welcome to NSBasic for Palm 4.4!

NS Basic/Palm 4.4 is a major new release of NS Basic with a great new feature: support for Garmin iQue devices, plus support for the 320x480 area that certain devices allow you.

We've also added some other enhancements and some bug fixes.

NS Basic/Palm is a complete development environment for Palm OS devices. NS Basic/Palm 4.4 creates programs for all Palm OS devices running Palm OS 3.1 or later, including Palm OS 5.x. It runs on Windows 95/98/ME/NT/2000/XP. Using Virtual PC, it will run on Mac OS. It will run on Linux using Win4Lin and VMWare.

Version 4.x is upwardly compatible with Version 3.x and 2.x. Programs written in those versions should be able to run in the new version without changes. The new Runtime will also work with your older compiled projects.

NS Basic/Palm is a commercial software product, licensed subject to the License Agreement that must be clicked on during installation. The Agreement also appears in the NS Basic/Palm Handbook.

This document contains what you need to know to install and run NS Basic/Palm.

Please visit our web site for the latest version of this document. You'll see the latest installation notes and updated news.

NS Basic/Palm Features

The easiest way to program Palm OS devices!

1. Book Edition

If you are running the Book Edition, welcome! This is a full version of NS Basic/Palm, with some restrictions: There is no need to download the NS Basic Runtime since the Book Edition automatically builds it into your app.

2. How to do a new installation of NS Basic/Palm

You can install NS Basic/Palm directly from this document if you are installing from the release CD. If you already have an earlier version of NS Basic/Palm installed, uninstall it first. The link immediately below to Nsbasic4.exe will only work if you are running this from the installer CD.

  1. Install NsbasicBookEdition.exe. This will install all the necessary files onto your desktop, and put NS Basic/Palm on your Start menu. Click on the link and select the option "Run this program from its current location".
    You may see the message "The publisher cannot be determined due to the problem below: Authenticode signature not found." It is safe to ignore this message.
  2. Once the installation is complete, start NS Basic/Palm. If you have the full version, enter your serial number (from the back of your Handbook) into Register under the Help menu. Otherwise, the programs you create will time out after 5 days.
  3. From the Run menu, download the NS Basic Runtime and Mathlib to your device. There is no need to download the Runtime if you set the Build Option for Fat Apps. Mathlib is only required if you are using the additional math functions.
  4. Register your copy so we can keep you up to date. (If you bought directly from us, you are automatically registered).
  5. To use Pocket Purchase, run its installer separately.
    If installing from the CD, run this installer.
    If you are downloading, run this installer.

If you are not able to install directly from this document, click on the file named Nsbasic4.exe.

If you have problems with the installation, see Tech Note 01.

Getting Started

From the Start... Programs... menu, select NS Basic/Palm OS, then NS Basic Palm IDE. It will bring up a dialog box. Select "Other Existing Projects" and pick one of the Samples. You will then be able to browse the project and compile the .prc file to run on your Palm device. You should also try the Tutorials: they are on the Start menu.

Using NS Basic/Palm with Windows Japanese, Chinese, Hebrew, Greek, etc.

NS Basic/Palm can work with double byte character sets. If there is a string table for your language, the settings will be automatic. Here is how to set up NS Basic/Palm: See also http://nsbasic.com/palm/Japanese/

3. How to run your program on your desktop

There are two ways to run your programs on the desktop. POSE lets you emulate a pre Palm OS 5.0 device, while the Simulator emulates a Palm OS 5.x device. You can download, start and stop programs on either one from within the NS Basic's Run menu. Use Tools...Options to select which one you want to use. Don't forget to download the Runtime if you are not building a Fat App.

Important: The Simulator, the ROM images and the associated files are licensed from PalmSource. When you install NS Basic, you agree to an End User License Agreement with PalmSource that has the terms of the license. A copy of the Agreement is in the \Program File\NSBasic folder.

POSE - Palm OS Emulator

NS Basic installs a copy of POSE with the ROM of a color Palm III running Palm OS 4.1. If you would like emulate a different device, you will also need to get the appropriate ROM image from the manufacturer of your device.

You may also be able to get a ROM image from your device. Using ROM Transfer.prc (in the Download folder), you can upload ROM images from most devices to the desktop. You can then use the transferred ROM file with POSE.

Each device has their own version of the ROM, sometimes with special features that are only on that device. The manufacturers sometimes, but not in all cases, have a special version of POSE that must be used.

The configuration of the Emulator is saved in the file \WINNT\Palm Emulator.ini.

If you want to get a copy of Palm's ROM or get the complete POSE documentation and files, go to http://www.palmos.com/dev/tools/emulator/. For more information on using POSE, see

Simulator

The Palm OS Simulator is Palm OS 5 running native on a Windows machine. It comes complete with a Palm OS 5 ROM, so there is no need to download or upload a ROM image. The Simulator puts a Palm OS 5 device on your desktop to run your programs. You can control it from within NS Basic in exactly the same manner as POSE.

The first time you run it, it will ask you to accept a license agreement. After doing so, shut down the Simulator and restart it. You may get error messages when doing so: you may ignore them.

Some manufacturers have special versions of the Simulator to emulate specific devices: for example, Pa1mOne has a Tungsten T|3 version. You can download this (after executing appropriate license agreements) from the PalmOne website. You can use it with NS Basic by changing the pathname to the Simulator in Tool...Options.

You can download the full Simulator from http://www.palmos.com/dev/tools/simulator/. This also includes full documentation on using the Simulator.


5. Warnings

See
Tech Note 01 for solutions to common problems.
  1. The new INF file format in Version 4.0 has more information about the proper types and numbers of arguments. It is possible that programs that worked before encounter compile errors now as a result. The old compiler allowed incorrect usage in some instances that are now flagged.

6. Documentation

  1. The NS Basic/Palm Handbook. It is shipped with each copy of NS Basic/Palm. It is approximately 140 pages and details all commands, functions and statement, with examples for each of them.
  2. The On line help contains a summary of all statements, functions, objects and constants.
  3. The Tech Notes contain detailed information on a number of topics, including add ons to NS Basic.
  4. Sample Code: We have a selection of programs submitted by NS Basic/Palm users here on the web site. There are many more in the Files section of the NS Basic Web Board. Some cool stuff here!
  5. NS Basic Programming for Palm OS: This is an excellent book, by Michael Verive, that discusses NS Basic tips and techniques. 317 pages.

7. Support

We're committed to delivering the best possible support. The following resources are available:
  1. See the list of Common Problems.
  2. The NS Basic/Palm Web Board. Post questions and comments, and get answers in a public forum, plus more samples to download. Essential!
  3. Email Support: Send your questions to support@nsbasic.com
  4. Tech Notes: The Tech Notes posted on our web site give additional and specialized information on a wide variety of topics.
  5. Updaters: From time to time, we may offer updates to NS Basic/Palm modules for download at no charge. Register your copy to make sure you are on the list.
We do not offer support by phone. Many problems involve looking at code and many solutions involve complex web addresses that don't communicate well by voice. Try the email support - it works better and we do our best to respond quickly!
Copyright (c) 2004 NS BASIC Corporation